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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project: Technical Specification 
Group Services and System Aspects; Telecommunication management, as identified below: 

32.411 : "Performance Management (PM) Integration Reference Point (IRP): Requirements" 

32.412: "Performance Management (PM) Integration Reference Point (IRP): Information Service (IS)" 

32.413: "Performance Management (PM) Integration Reference Point (IRP): Common Object 

Request Broker Architecture (CORBA) Solution Set (SS)" 

32.415 "Performance Management (PM) Integration Reference Point (IRP): extensible Markup Language 

(XML) definitions" 

32.417: "Performance Management (PM) Integration Reference Point (IRP): SOAP Solution Set (SS)" 

The present document is part of a set of TSs which describe the requirements and information model necessary for the 
Telecommunication Management (TM) of 3G systems. The TM principles and TM architecture are specified in 
3GPPTS 32.101 [1] and 3GPPTS 32.102 [2]. 

A 3G system is composed of a multitude of Network Elements (NE) of various types and, typically, different vendors, 
which inter-operate in a co-ordinated manner in order to satisfy the network users' communication requirements. 
Any evaluation of PLMN-system behaviour will require performance data collected and recorded by its NEs according 
to a schedule established by the EM. 

This aspect of the management environment is termed Performance Management. The purpose of any Performance 
Management activity is to collect performance related data, which can be used to locate potential problems in the 
network. 
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Scope 



The present document specifies the Common Object Request Broker Architecture (CORBA) Solution Set (SS) for the 
IRP whose semantics is specified in PM (Performance Management) IRP: Information Service 3GPP TS 32.412 [7]. 

This Solution Set specification is related to 3GPP TS 32.412 [7]. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] 3GPP TS 32.41 1: "Telecommunication management; Performance Management (PM) Integration 

Reference Point (IRP): Requirements". 

[4] 3GPP TS 32.31 1: "Telecommunication management; Generic Integration Reference Point (IRP): 

Requirements". 

[5] 3GPP TS 32.303: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Common Object Request Broker Architecture 
(CORBA) Solution Set (SS)". 

[6] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 

convention for Managed Objects". 

[7] 3GPP TS 32.412: "Telecommunication management; Performance Management (PM) Integration 

Reference Point (IRP): Information Service (IS)". 

[8] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management: Information Service (IS)". 

[9] OMG TC Document telecom/98-1 1-01: "OMG Notification Service". 

http://www.omg.org/technologv/documents/ 

[10] 3GPP TS 32.401: "Telecommunication management; Performance Management (PM); Concept 

and requirements". 
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Definitions and abbreviations 



3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [1], 3GPP TS 32.102 [2], 
3GPP TS 32.401 [10], 3GPP TS 32.411 [3] and the following apply: 

IRP document version number string (or "IRPVersion"): See 3GPP TS 32.31 1 [4]. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CM Configuration Management 

CORBA Common Object Request Broker Architecture 

DN Distinguished Name 

EM Element Manager 

IDL Interface Definition Language 

IS Information Service 

MOC Managed Object Class 

NE Network Element 

OMG Object Management Group 

PM Performance Management 

SS Solution Set 



4 Architectural features 

The overall architectural feature of PMIRP is specified in 3GPP TS 32.41 1 [3]. 
This clause specifies features that are specific to the CORBA SS. 

4.1 Notifications 

Notifications are sent according to the Notification IRP: CORBA SS (see 3GPP TS 32.303 [5]). 
The contents of the PMIRP notifications are defined in the present document. 

4.2 Syntax for distinguished names and versions 

The format of a Distinguished Name is defined in 3GPP TS 32.300 [6]. 

The version of this IRP is represented as a string (see also clause 3 for versions). 
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5 Mapping 

5.1 Operation and Notification mapping 

PMIRP: IS 3GPP TS 32.412 [7] defines semantics of operation and notification visible across the PMIRP. 
Table 5.1.1 indicates mapping of these operations and notifications to their equivalents defined in this SS. 

Table 5.1.1 : Mapping from IS Operations and Notification to SS equivalents 



IS Operations/ notification 3GPP TS 32.412 [7] 


SS IMethod 


Qualifier 


createMeasurementJob 


create measurementjob 


M 


stopMeasurementJob 


stop measurementjob 


M 


suspendMeasurementJob 


suspend measurementjob 





resumeMeasurementJob 


resume measurementjob 





listMeasurementJobs 


list measurementjobs 


M 


createlhresholdMonitor 


create threshold monitor 





deletelhresholdMonitor 


delete threshold monitor 





listThresholdMonitors 


list threshold monitors 





suspendThresholdMonitor 


suspend threshold monitor 





resumelhresholdMonitor 


resume threshold monitor 





getlRPVersion 


get pm irp versions 


M 


getOperationProfile (see note) 


get pm irp operations profile 





getNotificationProfile (see note) 


get pm irp notification profile 





notifyMeasurementJobStatusChanged 


push structured events(See subclause 6.1) 


M 


notify ThresholdMonitorObjectCreation 


push structured events (See subclause 6.1) 





notifyThresholdMonitorObjectDeletion 


push structured events (See subclause 6.1) 





notify ThresholdMonitorStatusChanged 


push structured events(See subclause 6.1) 





NOTE: This operation is of IVIanagedGenericIRP IOC specified in 3GPP TS 32.312 [8]. The PMIRP IOC of [7] 
inherits from it. 



5.2 Operation parameter mapping 

The PMIRP: IS 3GPP TS 32.412 [7] defines semantics of parameters carried in operations across the PMIRP. The 
following tables indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 5.2.1 : Mapping from IS createMeasurementJob parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iocName 


PMIRPConstDefs::MOCIassName mo_class 


M 


loclnstanceLlst 


PMIRPConstDefs::MOInstanceList mojnstancejist 


M 


measurementCategoryList 


PMIRPConstDefs::MeasurementCategoryList measurement_categoryJist 


M 


granularityPeriod 


PMIRPConstDefs::GranularityPeriod granularity_period 


M 


reportingPeriod 


PMIRPConstDefs::ReportingPeriod reporting_period 


M 


startTime 


PMIRPConstDefs::IRPTimeOpt start Jime 





stopTime 


PIVIIRPConstDefs::IRPTimeOptstopJime 





Schedule 


PMIRPConstDefs::ScheduleOpt schedule 





Jobid 


PIVIIRPConstDefs::Jobld jobjd 


M 


unsupported List 


PIVIIRPConstDefs::JUnsupportedList unsupportedjist 


M 


priority 


PMIRPConstDefs::JobPrJorityOpt priority 





status 


Return value of type ManagedGenericlRPConstDefs::Signal 

Exception: 

CreatelVleasurementJob, ManagedGenericlRPSystem::lnvalidParameter, 

ManagedGenericlRPSystem::ParameterNotSupported, HighWorkLoad 


M 
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Table 5.2.2: Mapping from IS stopMeasurement Job parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


jobid 


PMIRPConstDefs::Jobld jobjd 


M 


status 


Return value of type PMIRPConstDefs::Result 

Exception: 

StopMeasurementJob, UnknownJob, JobCannotBeStopped 


M 



Table 5.2.3: Mapping from IS suspendMeasurement Job parameters to SS equivalents 



IS Operation 
parameter 


SS Method parameter 


Qualifier 


jobId 


PMIRPConstDefs::Jobld jobJd 


M 


status 


Return value of type PMIRPConstDefs::Result 

Exception: 

SuspendMeasurementJob, UnknownJob, JobAlreadySuspended, 

IVIanagedGenericlRPSystem::OperationNotSupported 


M 



Table 5.2.4: Mapping from IS resiuneMeasurement Job parameters to SS equivalents 



IS Operation 
parameter 


SS Method parameter 


Qualifier 


jobId 


PIVllRPConstDefs::Jobld jobJd 


M 


status 


Return value of type PIVIIRPConstDefs::Result 

Exception: 

ResumeMeasurementJob, UnknownJob, JoblsNotSuspended, HighWorkLoad, 

l\/lanagedGenericlRPSystem::OperationNotSupported 


M 



Table 5.2.5: Mapping from IS llstMeasurementJobs parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


jobldList 


PMIRPConstDefs::JobldListjob_list_id 


M 


joblnfoList 


PMIRPConstDefs::JoblnfoListjob_info_list 


M 


status 


Return value of type PMIRPConstDefs::Result 

Exception: 

LlstMeasurementJobs, ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 5.2.6: Mapping from IS createXhresholdMonltor parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iocName 


PMIRPConstDefs::MOCIassName mo_class 


M 


loclnstanceLlst 


PMIRPConstDefs::MOInstanceLlst mojnstancejist 


M 


thresholdlnfoLlst 


PMIRPConstDefs::ThresholdlnfoLlstthreshold_lnfo_llst 


M 


monitorOranularityPerlod 


PMIRPConstDefs::MonltorGranularltyPerlod monitor_granularity_period 


M 


monitorld 


PMIRPGonstDefs::Monltorld monltorjd 


M 


unsupported List 


PMIRPGonstDefs::MUnsupportedLlst unsupportedjist 


M 


status 


Return value of type ManagedGenerlclRPGonstDefs::Signal 

Exception: 

CreateThresholdMonitor, ManagedGenerlclRPSystem::lnvalidParameter, 

ManagedGenerlclRPSystem::OperatlonNotSupported 


M 
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Table 5.2.7: Mapping from IS deleteXhresholdMonitor parameters to SS equivalents 



IS Operation 
parameter 


SS Method parameter 


Qualifier 


monitorld 


PMIRPConstDefs::Monitorld monitorjd 


M 


status 


Return value of type PMIRPConstDefs::Result 

Exception: 

DeleteXhresholdMonitor, UnknownThresholdMonitor, 

ManagedGenericlRPSystem::OperationNotSupported 


M 



Table 5.2.8: lUlapping from IS listxhresholdMonltors parameters to SS equivalents 



IS Operation 
parameter 


SS Method parameter 


Qualifier 


monltorldList 


PMIRPConstDefs::MonitorldList monitorjdjist 


M 


monitorlnfoList 


PMIRPConstDefs::MonitorlnfoList monitorjnfojist 


M 


status 


Return value of type PMIRPConstDefs::Result 

Exception: 

ListThresholdMonitors, ManagedGenericlRPSystem::lnvalidParameter, 

ManagedGenericlRPSystem::OperationNotSupported 


M 



Table 5.2.9: IVIapping from IS suspendxhresholdMonitor parameters to SS equivalents 



IS Operation 
parameter 


SS Method parameter 


Qualifier 


monitorld 


PIVllRPConstDefs::Monitorld monitorjd 


M 


status 


Return value of type PMIRPGonstDefs::Result 

Exception: 

SuspendThresholdMonitor, UnknownThresholdMonitor, 

ThresholdMonitorAlreadySuspended, ManagedGenericlRPSystem::OperationNotSupported 


M 



Table 5.2.10: IVIapping from IS resumeXhresholdMonltor parameters to SS equivalents 



IS Operation 
parameter 


SS Method parameter 


Qualifier 


monitorld 


PMIRPConstDefs::Monitorld monitorjd 


M 


status 


Return value of type PMIRPConstDefs::Result 

Exception: 

ResumelhresholdMonitor, UnknownThresholdMonitor, ThresholdMonitorlsNotSuspended, 

ManagedGenericlRPSystem::OperationNotSupported 


M 



Table 5.2.11 : IVIapping from IS getiRPVerslon parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumberSet 


Return value of type ManagedGenericlRPConstDefs::VersionNumberSet 


M 


status 


Exception: 
GetPMIRPVersions 


M 



Table 5.2.12: IVIapping from IS getoperatlonProflle parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


IRPVersion 


ManagedGenericlRPConstDefs::VersionNumber pmJrp_version 


M 


operationNameProfile, 
operationParameterProfile 


Return value of type ManagedGenericlRPConstDefs::MethodLlst 


M 
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IS Operation parameter 


SS Method parameter 


Qualifier 


status 


Exception: 

GetPMIRPOperationsProfile, 

ManagedGenericlRPSystem::OperationNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 5.2.13: Mapping from IS getNotlf icatlonProflle parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


ManagedGenericlRPConstDefs::VersionNumber pm_irp_version 


M 


notificationNameProfile, 
notificationParameterProfile 


Return value of type ManagedGenericlRPGonstDefs;:MethodList 


M 


status 


Exception: 

GetPIVIIRPNotificationProfile, 

IVIanagedGenericlRPSystemiiOperationNotSupported, 

l\/lanagedGenericlRPSystem::lnvalidParameter 


M 



5.3 Notification parameter mapping 

The PMIRP: IS 3GPP TS 32.412 [7] defines semantics of parameters carried in notifications. The following table 
indicates the mapping of these parameters to their OMG CORB A Structured Event (defined in OMG Notification 
Service [9]) equivalents. The composition of OMG Structured Event, as defined in the OMG Notification Service [9], 



Header 



Body 



Fixed Header 

domain_name 

type_name 

event_name 
Variable Header 

f ilterable_body_f ields 
remaining_body 



The following tables list all OMG Structured Event attributes in the second column. The first column identifies the 
PMIRP: IS 3GPP TS 32.412 [7] defined notification parameters. 
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Table 5.3.1: Mapping for notifyMeasurementJobStatusChanged 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 


M 


It carries the IRP document version number string. See 
subclause 3.1. 

It indicates the syntax and semantics of the Structured Event as 
defined by the present document. 


notificationType 


type_name 


M 


This is constant string "notifyMeasurementJobStatusChanged". 


There is no 
corresponding IS 
attribute. 


event_name 


M 


It carries no information. 


There is no 
corresponding IS 
attribute. 


Variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


NV stands for name-value pair. Order arrangement of NV pairs is 
not significant. The name of NV-pair is always encoded in string. 

Name of this NV pair is the MANAGED_OBJECT_INSTANCE of 
interface AttributeNameValue of module 
Notification 1 RPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.303 [5]). 


notificatlonid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NOTIFICATIONJD of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a long. See corresponding table in Notification 
IRP: CORBA SS (3GPP TS 32.303 [5]). 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the EVENT_TIME of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.303 [5]). 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the SYSTEI\/I_DN of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.303 [5]). 


jobid 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the JOBJD of 
PMIRPNotifications::notifyMeasurementJobStatusChanged. 

Value of NV pair is JobId of module PMIRPConstDefs. 


jobStatus 


One NV pair of 
remaining_body 


M 


Name of NV pair is the JOB_STATUS of 
PMIRPNotifications::notifyMeasurementJobStatusChanged. 

Value of NV pair is JobStatus of module PIVIIRPConstDefs. 


reason 


One NV pair of 
remainingbody 





Name of NV pair is the REASON of 
PMIRPNotifications::notifyMeasurementJobStatusChanged. 

Value of NV pair is a string. 



Table 5.3.2: IVIapping for notifyThresholdMonitorObjectCreation 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 


M 


It carries the IRP document version number string. See 
subclause 3.1. 

It indicates the syntax and semantics of the Structured 
Event as defined by the present document. 
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IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


notificationType 


type_name 


M 


This is constant string 
"notifyThresholdMonitorObjectCreation". 


There is no 
corresponding IS 
attribute. 


event_name 


M 


It carries no information. 


There is no 
corresponding IS 
attribute. 


Variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


NV stands for name-value pair. Order arrangement of NV 
pairs is not significant. The name of NV-pair is always 
encoded in string. 

Name of this NV pair is the 
MANAGED_OBJECT_INSTANCE of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.303 [5]). 


notificationid 


One NV pair of 
remaining body 


M 


Name of NV pair is the NOTIFICATIONJD of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a long. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.303 [5]). 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the EVENT_TIIVIE of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.303 [5]). 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the SYSTEIVI_DN of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.303 [5]). 


monitorld 


One NV pair of 
remaining body 


M 


Name of NV pair is the IVIONITORJD of module 
PIVIIRPNotifications::notifyThresholdMonitorObjectCreation. 

Value of NV pair is IVIonitorld of module PMIRPConstDefs. 


monitorGranularityPeriod 


One NV pair of 
remaining body 


M 


Name of NV pair is the 

MONITOR_GRANULARITY_PERIOD of module 
PIVIIRPNotifications::notifyThresholdlVlonitorObjectCreation. 

Value of NV pair is IVIonitorGranularityPerlod of module 
PMIRPConstDefs. 


thresholdMonitorStatus 


One NV pair of 
remaining body 


M 


Name of NV pair is the MONITOR_STATUS of module 
PIVIIRPNotifications::notifyThresholdlVlonitorObjectCreation. 

Value of NV pair is IVIonitorStatus of module 
PMIRPConstDefs. 
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Table 5.3.3: Mapping for notifyThresholdMonitorObjectDeletion 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 


M 


It carries the IRP document version number string. See 
subclause 3.1. 

It indicates the syntax and semantics of the Structured Event as 
defined by the present document. 


notificationType 


type_name 


M 


This is constant string "notifyThresholdMonitorObjectDeletion". 


There is no 
corresponding IS 
attribute. 


event_name 


M 


It carries no information. 


There is no 
corresponding IS 
attribute. 


Variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


NV stands for name-value pair. Order arrangement of NV pairs is 
not significant. The name of NV-pair is always encoded in string. 

Name of this NV pair is the MANAGED_OBJECT_INSTANCE of 
interface AttributeNameValue of module 
NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.303 [5]). 


notificationid 


One NV pair of 
remaining body 


M 


Name of NV pair is the NOTIFICATIONJD of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a long. See corresponding table in Notification 
IRP: CORBA SS {3GPP TS 32.303 [5]). 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the EVENT_TIME of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.303 [5]). 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the SYSTEIVI_DN of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.303 [5]). 


monitorld 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the MONITORJD of 
PMIRPNotifications::notifyThresholdMonitorObjectDeletion. 

Value of NV pair is IVIonitorld of module PMIRPConstDefs. 
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Table 5.3.4: Mapping for notifyThresholdMonitorStatusChanged 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 


M 


It carries the IRP document version number string. See 
subclause 3.1. 

It indicates the syntax and semantics of the Structured Event as 
defined by the present document. 


notificationType 


type_name 


M 


This is constant string "notifyThresholdMonitorStatusChanged". 


There is no 
corresponding IS 
attribute. 


event_name 


M 


It carries no information. 


There is no 
corresponding IS 
attribute. 


Variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


NV stands for name-value pair. Order arrangement of NV pairs is 
not significant. The name of NV-pair is always encoded in string. 

Name of this NV pair is the MANAGED_OBJECT_INSTANCE of 
interface AttributeNameValue of module 
NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.303 [5]). 


notificatlonid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NOTIFICATIONJD of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a long. See corresponding table in Notification 
IRP: CORBA SS {3GPP TS 32.303 [5]). 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the EVENT_TIME of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.303 [5]). 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the SYSTEIVI_DN of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.303 [5]). 


monitorld 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the MONITORJD of 
PMIRPNotifications::notifyThresholdMonitorStatusChanged 

Value of NV pair is IVIonitorld of module PIVIIRPConstDefs. 


monitorStatus 


One NV pair of 
remaining_body 


M 


Name of NV pair is the MONITOR _STATUS of 
PMIRPNotifications::notifyThresholdMonitorStatusChanged 

Value of NV pair is IVIonitorStatus of module PMIRPConstDefs. 


reason 


One NV pair of 
remaining_body 





Name of NV pair is the REASON of 
PIVIIRPNotifications::notifyThresholdMonitorStatusChanged 

Value of NV pair is a string. 
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PMIRPNotification Interface 



OMG CORBA Notification push operation is used to realise the notification of PMIRP Notifications. All the 
notifications in this interface are implemented using this push_structured_event method. 

6.1 Method push (M) 

module CosNotifyComm { 

Interface SequencePushConsumer : NotifyPublish { 
void push_structured_events { 

in CosNotif ication: lEventBatch notifications) 
raises { CosEventComm: : Disconnected) ; 

} ; // SequencePushConsumer 

} ; // CosNotifyComm 

NOTE 1: The push_structured_events method takes an input parameter of type EventBatch as defined 
in the OMG CosNotif ication module (OMG Notification Service [9]). This data type is the same as 
a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of Structured 
Events being delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is 
controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate 
individual events into the sequence before invoking this operation is controlled by IRP Agent wide 
configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 
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Annex A (normative): 
IDL specifications 

A.1 IDL specification (file name "PIVIIRPConstDefs.idI") 

//File: PMIRPConstDefs.idl 
#ifndef _PM_IRP_CONST_DEFS_IDL_ 
#define _PM_IRP_CONST_DEFS_IDL_ 

#include <TimeBase . idl> 

// This statement must appear after all include statements 
ipragma prefix "3gppsa5.org" 

/* ## Module: PMIRPConstDefs 

This module contains commonly used definitions for PM IRP 



*/ 

module PMIRPConstDefs 

{ 

enum Result {OK, FAILURE}, - 

typedef string MOClassName; 

typedef string MOInstance; 

typedef sequence<MOInstance> MOInstanceList ; 

typedef string MeasurementCategory; 

typedef sequence<MeasurementCategory> MeasurementCategoryList ; 

typedef unsigned long GranularityPeriod; //The unit is minute. 

typedef unsigned long ReportingPeriod; //The unit is minute. 

typedef TimeBase : :UtcT UTCTime; 

union IRPTimeOpt switch (boolean) 

case TRUE: UTCTime value ; 



struct Time24 

unsigned short hour; // 0-23 
unsigned short minute; // 0-59 



struct IntervalOfDay 

Time24 interval_start_time; 
Time24 interval_stop_time; 

typedef sequence<IntervalOfDay> DailyScheduling; 

const short SUNDAY = 1; 
const short MONDAY = 2 ; 
const short TUESDAY = 4; 
const short WEDNESDAY = 8; 
const short THURSDAY = 16; 
const short FRIDAY = 32; 
const short SATURDAY = 64; 

typedef short DaysOfWeek; 
// Bit mask of week days, 
// e.g. "SUNDAYd) and WEDNESDAY {8 ) " is encoded as 9. 

struct WeeklySchedulingElement 

{ 

DaysOfWeek days ; 

DailyScheduling interval s_of_day; 

}; 

typedef sequence<WeeklySchedulingElement> WeeklyScheduling; 
enum ScheduleType { DAILY, WEEKLY }; 
union Schedule switch (ScheduleType) 

{ 

case DAILY: DailyScheduling daily_scheduling; 
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case WEEKLY: WeeklyScheduling weekly_scheduling; 

}; 

union ScheduleOpt switch (boolean) 

{ 

case TRUE: Schedule value; 



typedef unsigned long Jobid; 
typedef sequence<JobId> JobldList; 
struct JUnsupported 

{ 

MOInstance mo_instance; 

Measurement Category measurement_category; 

string reason; 

}; 

typedef sequence<JUnsupported> JUnsupportedList ; 

/** 
* Defines the name of an attribute of a Managed Object 



typedef string MOAttributeName; 

enum JobStatus {SCHEDULED, ACTIVE, SUSPENDED, STOPPED} 
enum JobPriority {LOW, MEDIUM, HIGH}; 
union JobPriorityOpt switch (boolean) 

{ 

case TRUE: JobPriority value; 



struct Joblnfo 

{ 

JobId job_id; 

MOC las sName mo_c lass; 

MOInstanceList mo_instance_list ; 

MeasurementCategoryList measurement_category_list ; 

GranularityPeriod granularity_period; 

Report ingPeriod report ing_period; 

IRPTimeOpt start_time; 

IRPTimeOpt stop_time; 

ScheduleOpt schedule; 

JobStatus job_status; 

JobPriorityOpt job_priority; 

}; 

typedef sequence<JobInf o> JoblnfoList; 

typedef string MeasurementTypeName; 

typedef string SubCounterName; 

typedef short ProbableCause; //THRESHOLD^CROSSED = 351; 

typedef string Specif icProblem; 

typedef any ThresholdValue; 

enum Severity {WARNING, MINOR, MAJOR, CRITICAL}; 

union Hysteresis switch (boolean) 

{ 

case TRUE: long long_value; 
case FALSE: float float_value; 

}; 

enum Direction { INCREASING, DECREASING}; 
struct ThresholdPackElement 

{ 

ThresholdValue threshold_value; 
Severity severity_; 
Hysteresis hysteresis_; 

}; 

typedef sequence<ThresholdPackElement> ThresholdPack; 
struct Thresholdlnfo 

{ 

MeasurementTypeName measurement_type_name ; 
SubCounterName sub_counter_name ; 
ProbableCause probable_cause; 
Specif icProblem specif ic_problem; 
Direction direction_; 
ThresholdPack threshold_pack; 

}; 

typedef sequence<ThresholdInfo> ThresholdlnfoList ; 

typedef GranularityPeriod MonitorGranularityPeriod; // time period is based on 5 minutes. 

typedef unsigned long Monitorld; 

struct MUnsupported 
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MOInstance mo_instance; 

MeasurementTypeName measurement_type_name ; 
SubCounterName sub_counter_name ; 
string reason; 

}; 

typedef sequence<MUnsupported> MUnsupportedList ; 
enum MonitorStatus {M_SUSPENDED, M_ACTIVE}; 

typedef sequence<MonitorId> MonitorldList ; 

typedef string _EventType; // The value is "Quality of Service Alarm" 

struct Monitorlnfo 

{ 

Monitorld monitor_id; 
MOC las sName mo_c 1 a s s ; 
MOInstanceList mo_instance_list ; 

MonitorGranularityPeriod monitor_granularity_period; 
Thresholdlnf oList threshold_inf o_list ; 
MonitorStatus threshold_monitor_status ; 
_EventType event_type ; 

}; 

typedef sequence<MonitorInfo> MonitorlnfoList ; 
/** 

* This block identifies attributes which are included as part of the 

* PMIRP. These attribute values should not 

* clash with those defined for the attributes of notification 

* header {see IDL of Notification IRP) . 
*/ 

interface AttributeNameValue 

{ 

const string JOB_ID = "JOB_ID"; 

const string JOB_STATUS = " JOB_STATUS" ; 

const string REASON = "REASON"; 

const string MONITOR_ID = "MONITOR_ID" ; 

const string MONITOR_STATUS = "MONITOR_STATUS" ; 

const string MONITOR_GRANULARITY_PERIOD = "MONITOR_GRANULARITY_PERIOD" 

const string MONITOR_EVENT_TYPE = "MONITOR_EVENT_TYPE" ; 

const string PROBABLE_CAUSE = "PROBABLE_CAUSE" ; 

const string SPECIFIC_PROBLEM = "SPECIFIC_PROBLEM" ; 

const string DIRECTION = "DIRECTION"; 

}; 
}; 

#endif // _PM_IRP_CONST_DEFS_IDL_ 
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A.2 IDL specification (file name "PIVIIRPSystem.idI") 

//File: PMIRPSystem.idl 
iifndef _PM_IRP_SYSTEM_IDL_ 
#define _Piyi_IRP_SYSTEM_IDL_ 

#include <ManagedGenericIRPSystem. idl> 
#include <ManagedGenericIRPConstDef s . idl> 
#include <PMIRPConstDef s . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: PMIRPSystem 

This module contains the specification of all operations of PM IRP Agent. 



*/ 

module PMIRPSystem 

{ 

/** 

* The reason specifies whether EM or NE has high workload. The value shall be one 

* of following: emCpuBusy; emHDShortage, emLowMemory, {neCpuBusy, neObjectlnstList } 

* {neHDShortage neObjectlnstList}, {neLowMemory, neObjectlnstList}, maxJobReached, 

* otherReason. 

* In the case the reason is a tuple, the first element is the string such as 

* "NE_CPU_BUSY" followed by a comma, then followed by a sequence of DN where 

* each DN is separated by its adjacent DN, if any, by a colon. The DN is formatted 

* as described in 32.300. 
*/ 

exception HighWorkLoad { string reason; }; 
interface HighWorkLoadExceptionReason 

{ 

const string EM_CPU_BUSY = "EM_CPU_BUSY" ; 
const string EM_HD_SHORTAGE = "EM_HD_SHORTAGE" ; 
const string EM_LOW_MEMORY = " EM_LOW_MEMORY " ; 
const string NE_CPU_BUSY = "NE_CPU_BUSY" ; 
const string NE_HD_SHORTAGE = "NE_HD_SHORTAGE" ; 
const string NE_LOW_MEMORY = " NE_LOW_MEMORY " ; 
const string MAX_JOB_REACHED = "MAX_JOB_REACHED" ; 
const string OTHER_REASON = "OTHER_REASON" ; 

}; 

exception UnknownJob { string reason; }; 

exception JobCannotBeStopped { string reason; }; 

exception JobAlreadySuspended { string reason; }; 

exception JoblsNotSuspended { string reason; }; 

exception UnknownThresholdMonitor { string reason; }; 

exception ThresholdMonitorAlreadySuspended { string reason; }; 

exception ThresholdMonitorlsNotSuspended { string reason; }; 

/** 

* System fails to complete the operation. System can provide reason 

* to qualify the exception. The semantics carried in reason 

* is outside the scope of this IRP. 
*/ 

exception GetPMIRPVersions { string reason; }; 
exception GetPMIRPOperationsProf ile { string reason; }; 
exception GetPMIRPNotif icationProf ile { string reason; }; 
exception CreateMeasurementJob { string reason; }; 
exception StopMeasurementJob { string reason; }; 
exception SuspendMeasurementJob { string reason; }; 
exception ResumeMeasurementJob { string reason; }; 
exception ListMeasurementJobs { string reason; }; 
exception CreateThresholdMonitor { string reason; }; 
exception DeleteThresholdMonitor { string reason; }; 
exception ListThresholdMonitors { string reason; }; 
exception SuspendThresholdMonitor { string reason; }; 
exception ResumeThresholdMonitor { string reason; }; 

interface PMIRP 

{ 

readonly attribute string iRPId; 

/** 

* Return the list of all supported PM IRP versions. 
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*/ 

ManagedGenericIRPConstDef s : iVersionNumberSet get_pm_irp_versions { 

) 

raises (GetPMIRPVersions) ; 

/** 

* Return the list of all supported operations and their supported 

* parameters for a specific PM IRP version. 
*/ 

ManagedGenericIRPConstDef s : iMethodList get_pm_irp_operations_prof ile { 

in ManagedGenericIRPConstDef s : iVersionNumber pm_irp_version 
) 
raises {GetPMIRPOperationsProf ile , 

ManagedGenericIRPSystem: lOperationNot Supported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/** 

* Return the list of all supported notifications and their supported 

* parameters for a specific PM IRP version. 
*/ 

ManagedGenericIRPConstDef s : iMethodList get_pm_irp_notif ication_prof ile 
{ 

in ManagedGenericIRPConstDef s : iVersionNumber pm_irp_version 
) 
raises {GetPMIRPNotif icationProf ile, 

ManagedGenericIRPSystem: lOperationNot Supported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/** 

* Request to create a Measurement Job through Itf-N. 
*/ 

ManagedGenericIRPConstDef s :: Signal create_measurement_job { 



MOClassName mo_class, 

MOInstanceList mo_instance_list , 

MeasurementCategoryList measurement_category_list , 

GranularityPeriod granularity_period. 

Report ingPeriod report ing_period, 

IRPTimeOpt start_time, 

IRPTimeOpt stop_time, 

ScheduleOpt schedule, 

JobPriorityOpt priority, 

iJobId job_id, 

: JUnsupportedList unsupported_list 



in PMIRPConstDef s 

in PMIRPConstDef s 

in PMIRPConstDef s 

in PMIRPConstDef s 

in PMIRPConstDef s 

in PMIRPConstDef s 

in PMIRPConstDef s 

in PMIRPConstDef s 

in PMIRPConstDef s 

out PMIRPConstDef s 

out PMIRPConstDef s 
) 
raises {CreateMeasurementJob, 

ManagedGenericIRPSystem: : InvalidParameter, 
ManagedGenericIRPSystem: : ParameterNotSupported, 
HighWorkLoad) ; 

/** 

* Request to stop a MeasurementJob through Itf-N, after which, 

* the MeasurementJob will still be visible via Itf-N. Whether 

* the MeasurementJob is thoroughly removed immediately from 

* the managed system is vendor specific. 
*/ 

PMIRPConstDef s : :Result stop_measurement_job { 

in PMIRPConstDef s : :JobId job_id) 
raises {StopMeasurementJob, 

Unknown Job , 

JobCannotBeStopped) ; 

/** 

* Request to suspend a MeasurementJob 
*/ 

PMIRPConstDef s : :Result suspend_measurement_job { 

in PMIRPConstDef s : :JobId job_id) 
raises {SuspendMeasurementJob, 

Unknown Job , 

JobAlreadySuspended, 

ManagedGenericIRPSystem: :OperationNotSupported) ; 

/** 

* Request to resume a MeasurementJob 
*l 

PMIRPConstDef s : :Result resume_measurement_job { 

in PMIRPConstDef s : :JobId job_id) 
raises {ResumeMeasurementJob, 
Unknown Job , 
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JobI sNotSuspended , 

HighWorkLoad , 

ManagedGenericIRPSystem: lOperationNotSupported) ; 

/** 

* Request to list the information of all or of specified 

* MeasurementJobs 
*/ 

PMIRPConstDef s : iResult list_measurement_jobs ( 

in PMIRPConstDef s : iJobldList job_list_id, 

out PMIRPConstDef s : iJoblnfoList j ob_inf o_list ) 
raises {ListMeasurementJobs, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/** 

* Request to create a ThresholdMonitor to define the threshold 

* for some specific measurementTypes or subCounters 
*/ 

ManagedGenericIRPConstDef s :: Signal create_threshold_monitor { 



in PMIRPConstDef s 
in PMIRPConstDef s 
in PMIRPConstDef s 
in PMIRPConstDef s 
out PMIRPConstDef s 
out PMIRPConstDef s 



iMOClassName mo_class, 
iMOInstanceList mo_instance_list , 
: Thresholdinf oList threshold_inf o_list , 
iMonitorGranularityPeriod monitor_granularity_period, 
iMonitorld monitor_id, 
iMUnsupportedList unsupported_list) 
raises {CreateThresholdMonitor, 

ManagedGenericIRPSystem: : InvalidParameter, 
ManagedGenericIRPSystem: :OperationNotSupported) ; 

/** 

* Request to delete a specified ThresholdMonitor 
*/ 

PMIRPConstDef s : :Result delete_threshold_monitor { 

in PMIRPConstDef s : :MonitorId monitor_id) 
raises {DeleteThresholdMonitor, 

UnknownThresholdMonitor, 

ManagedGenericIRPSystem: :OperationNotSupported) ; 

/** 

* Request to list detailed information about all or 

* specified ThresholdMonitors 
*/ 

PMIRPConstDef s : :Result list_threshold_monitors { 

in PMIRPConstDef s : :MonitorIdList monitor_id_list , 
out PMIRPConstDef s : :MonitorInfoList monitor_inf o_list) 
raises {ListThresholdMonitors, 

ManagedGenericIRPSystem: : InvalidParameter, 
ManagedGenericIRPSystem: :OperationNotSupported) ; 

/** 

* Request to suspend a ThresholdMonitor 
*/ 

PMIRPConstDef s : :Result suspend_threshold_monitor { 
in PMIRPConstDef s : :MonitorId monitor_id) 

raises {SuspendThresholdMonitor, 
UnknownThresholdMonitor, 
ThresholdMonitorAlreadySuspended, 
ManagedGenericIRPSystem: :OperationNotSupported) ; 

/** 

* Request to resume a ThresholdMonitor 
*/ 

PMIRPConstDef s : :Result resume_threshold_monitor { 
in PMIRPConstDef s : :MonitorId monitor_id) 

raises {ResumeThresholdMonitor, 
UnknownThresholdMonitor, 
ThresholdMonitor I sNotSuspended , 
ManagedGenericIRPSystem: :OperationNotSupported) ; 



}; 



#endif // PM IRP SYSTEM IDL 
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A.3 IDL specification (file name "PIVIIRPNotifications.idI") 

// File: PMIRPNotif ications . idl 
#ifndef _Piyi_IRP_NOTIFICATIONS_IDL_ 
#define _PM_IRP_NOTIFICATIONS_IDL_ 

#include <PMIRPConstDef s . idl> 

#include <NotificationIRPNotif ications . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: PMIRPNotif ications 

This module contains the specification of all notifications of PM IRP Agent. 



*/ 

module PMIRPNotif ications 

{ 

/** 

* Constant definitions for the notifyMeasurementJobStatusChanged notification 
*/ 

interface NotifyMeasurementJobStatusChanged: NotificationlRPNotif ications : :Notify 

{ 

const string EVENT_TYPE = "notifyMeasurement JobStatusChanged" ; 

/** 

* This constant defines the name of the jobid property. 

* The data type for the value of this property 

* is PMIRPConstDefs: : Jobld. 
*/ 

const string JOB_ID = PMIRPConstDefs :: AttributeNameValue : :JOB_ID; 

/** 

* This constant defines the name of the jobStatus property. 

* The data type for the value of this property 

* is PMIRPConstDefs :: JobStatus . 
*/ 

const string JOB_STATUS = PMIRPConstDefs :: AttributeNameValue :: JOB_STATUS ; 

/** 

* This constant defines the name of the reason property. 

* The data type for the value of this property is string. 
*/ 

const string REASON = PMIRPConstDefs :: AttributeNameValue :: REASON; 

}; 

* Constant definitions for the not ifyThresholdMonitorObject Great ion notification 

*/ 

interface Notif yThresholdMonitorOb j ectCreation : 
NotificationlRPNotif ications : :Notify 

{ 

const string EVENT_TYPE = "notifyThresholdMonitorObj ectCreation" ; 
/** 

* This constant defines the name of the monitorld property, 

* which is transported in the f ilterable_body fields. 

* The data type for the value of this property 

* is PMIRPConstDefs : :MonitorId. 
*/ 

const string MONITOR_ID = PMIRPConstDefs :: AttributeNameValue : :MONITOR_ID; 
/** 

* This constant defines the name of the monitorGranularityPeriod property, 

* which is transported in the f ilterable_body fields. 

* The data type for the value of this property 

* is PMIRPConstDefs : :MonitorGranularityPeriod. 
*/ 

const string MONITOR_GRANULARITY_PERIOD = 

PMIRPConstDefs: : AttributeNameValue : :MONITOR_GRANULARITY_PERIOD; 
/** 

* This constant defines the name of the thresholdMonitorStatus property, 

* which is transported in the f ilterable_body fields. 

* The data type for the value of this property 

* is PMIRPConstDefs : :MonitorStatus . 
*/ 

const string MONITOR_STATUS = 

PMIRPConstDefs: : AttributeNameValue : :MONITOR STATUS; 
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* Constant definitions for the notifyThresholdMonitorObjectDeletion notification 

*/ 

interface Notif yThresholdMonitorOb j ectDeletion : 
Notif icationlRPNotif ications : iNotify 

{ 

const string EVENT_TYPE = "notifyThresholdMonitorObj ectDeletion" ; 

/** 

* This constant defines the name of the monitorld property, 

* which is transported in the f ilterable_body fields. 

* The data type for the value of this property 

* is PMIRPConstDef s : :MonitorId. 
V 

const string MONITOR_ID = PMIRPConstDef s :: AttributeNameValue : :MONITOR_ID; 

}; 
/** 

* Constant definitions for the notifyThresholdMonitorStatusChanged notification 
*/ 

interface NotifyThresholdMonitorStatusChanged: Notif icationlRPNotif ications : iNotify 

{ 

const string EVENT_TYPE = "notifyThresholdMonitorStatusChanged" ; 

/** 

* This constant defines the name of the monitorld property. 

* The data type for the value of this property 

* is PMIRPConstDef s : iMonitorld. 
*/ 

const string MONITOR_ID = PMIRPConstDef s :: AttributeNameValue : :MONITOR_ID; 

/** 

* This constant defines the name of the monitorStatus property. 

* The data type for the value of this property 

* is PMIRPConstDef s : :MonitorStatus . 
*/ 

const string MONITOR_STATUS = PMIRPConstDef s :: AttributeNameValue : :MONITOR_STATUS ; 

/** 

* This constant defines the name of the reason property. 

* The data type for the value of this property is string. 
*/ 

const string REASON = PMIRPConstDef s :: AttributeNameValue :: REASON; 



#endif // PM IRP NOTIFICATIONS IDL 
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Annex B (informative): 
Change history 
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Correct IDL definition in PMIRPConstDefs.lDL to avoid keyword conflict 
with CORBA Releases beyond 2.3 


F 


6.8.0 


6.9.0 


Jun 2007 


SA_36 


— 


— 


— 


Automatic upgrade to Rel-7 (no CR) at freeze of Rel-7. Deleted reference 
to CMIP SS, discontinued from R7 onwards. 


— 


6.9.0 


7.0.0 


Mar 
2009 


SA-43 


SP- 
090207 


0013 


— 


Include reference to SOAP Solution Set specification 


D 


7.0.0 


8.0.0 


Dec 
2009 


- 


- 


- 


- 


Update to Rel-9 version (MCC) 


— 


8.0.0 


9.0.0 
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